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Appendix A - Example Messages and Message Elements 



I. Messages 

Posted Request and Notification Messages 

<Message> 
<Header> 

<To/> 

<From/> 

<Topic/>? 

<Expiration/>? 
</Header> 
<Body> 

<Docuirtent/>* 
</Body> 
</Message> 

Posted Response Messages 

<Message> 
<Header> 

<Token/> 

<From/> 

<Status/>? 
</Header> 
<Body> 

<Document/>* 
</Body> 
</Message> 

Delivered Request and Notification Messages 

<Message> 
<Header> 

<Session/> 

<Token/> 

<To/> 

<From/> 

<Topic/>? 
</Header> 
<Body> 

<Document/>* 
</Body> 
</Message> 

Delivered Response Messages 

<Message> 
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<Header> 

<Session/> 

<Token/> 

<To/> 

<Frorn/> 

<Topic/>? 

<Status/>? 
</Header> 
<Body> 

<Document/>* 
</Body> 
</Message> 



IL Message Elements 



<Message> 
Purpose: 
Message types 
Attributes: 



Root envelope for a message. 
All message types, 
type (required) = request | response | notification 
test (optional) = false (default) ] true 
Header- {l},Body-{l} 

Note: The test attribute indicates if the message is a test message - that the message should be 
routed with no persistent effects in any of the participating services. The message type is 
"request" when a message is delivered to an engine. 



Child Elements: 



<Header> 
Purpose: 
Message types: 
Attributes: 
Child Elements: 



<Session> 
Purpose: 



Root element for a message header. 

All message types. 

None. 

Session, Token, To, From, Topic, Status, Expiration {Cardinality of elements 
depends on message type} 



Unique session identifier assigned by message interchange network to the 
message. 

All delivered message types. 

id (required) = (globally unique identification string) 
None. 

Note: The session is effectively a "tracking slip" for messages. In one embodiment, all services 
in a message's route receive the same session identifier. The scope of a message session 
depends on the message type. For a request message, the message session includes the response 
as well - therefore response messages do not receive a new session. For a notification, the 



Message types: 

Attributes: 

Content: 
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message session only applies through to the recipients. In an alternative embodiment, a service 
can demand a new session for an included service, thereby hiding some services from being 
tracked by the original sender. 

<Token> 

Purpose: Unique reference identifier assigned by the message interchange network. 

Message types: All delivered message types. Posted response. 
Attributes: value (required) = (unique identification string) 

Content: None. 

Note: A token is used to uniquely identify a delivered message when issuing an acknowledge to 
polled delivery, and serves as a message reference in posted response messages. When a service 
posts a response message, the message includes the token from the previously received request 
message. 



<To> 

Purpose: Identification of the recipients of the message. 

Message types: All message types except posted response. 
Attributes: None. 
Child Elements: Service- { 1 :N} 

Note: The To element indicates the recipients of a posted request or notification message. In 
delivered messages, the To element indicates the service invoked and contains the arguments and 
cookie necessary for the service to process the message. Posted request and notification 
messages may have multiple recipients, in which case there will be multiple child Service 
elements. All delivered messages can include only one Service element. 



<Service> 
Purpose: 
Message types: 
Attributes: 



Identifies a service connected to the message interchange network 
All message types. 

gcid = (unique service identifier assigned by the message interchange 
network to the service); 

name = (name of organization owning the service)/(service name) 
Arguments- {0:1}, Cookie- {0:1} 
Note: At least one of the two attributes should appear in order to specify the service. If one of 
the attributes is omitted, the message interchange network fills in the omitted attribute when 
composing a header for delivery. 



Child Elements: 



<Arguments> 
Purpose: 



Text or parameters that further specifies what the service is to perform and 
how. 
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Message types: All message types. 
Attributes: None, 

Content: Text string (as xml CD ATA block). 

Note: The format of the argument string is up to each service to define. The Arguments element 
need not be parsed or verified by the message interchange network. It is the responsibility of the 
message composer to insert the necessary contents understandable by the service. Whether or 
not the text is XML, the contents of the Arguments element should be enclosed in a CD ATA 
block. 



<Cookie> 
Purpose: 



Message types: 

Attributes: 

Content: 



Service-defined block of text or parameters that a service wants delivered with 
invocation. 
All message types. 
None. 

Text string (as xml CD ATA block). 
Note: The cookie element contains a block of text (or xml) previously registered by a service 
with the message interchange network. The format of the cookie string is up to each service to 
define. The Cookie element need not be parsed or verified by the message interchange network. 
Whether or not the text is XML, the contents of the Cookie element will be enclosed in a 
CD ATA block. 



<From> 

Purpose: Identification of the sending (or invoking) service of the message. 

Message types: All message types. 
Attributes: None. 
Child Elements: Service- { 1 } 

Note: The From element indicates the sender of the message to the receiving services. In the 
delivery header, the service in the From element is the "logical" sender representing the service 
that included the receiving service into the message route. Thus, each receiving service 
perceives the received message as an invocation from the including service rather than a message 
coming from the originating sender service. 



<Topic> 

Purpose: Indicate the topic of the message. 

Message types: All message types except posted response. 
Attributes: None. 
Content: Dot-separated topic category. 

Note: Topic provides a categorization of the message. The categorization should be 
hierarchical, but the message interchange network need not have a predefined set of topics. The 
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Topic element is useful for services that push out events, where the topic can be the name of the 
event for which recipients are being notified. 



<Status> 

Purpose: Indicates the status of processing a request. 

Message types: Response. 

Attributes: None. 

Content: Dot-separated status code. 

Note: The status element provides a means for the respondent of a request message to indicate 
the success (or lack thereof) of processing the request message. Absence of the status element in 
a response message indicates unqualified success of the response. In the case of a qualified 
success (e.g., a warning, a fault, a failure, or other status), a service should include the status 
element and provide an appropriate status code indicating the problem. 



<Expiration> 

Purpose: Specifies a time by which a message must complete its routing. 

Message types: Posted request and notification. 
Attributes: units (optional) = msec (default) | sec | hr 

Content: numeric value. 

Note: The expiration specifies when the message must reach its final destination. For request 
messages, the expiration includes the return of the response message. For notification messages, 
the expiration only applies up to delivery to the recipients. Expiration time is measured against 
the time the message is first posted to the message interchange network. 



< Body> 
Purpose: 
Message types: 
Attributes: 
Child Elements: 

<Document> 
Purpose: 
Message types: 
Attributes: 



The root element for the actual message data. 

All message types. 

None. 

Document- {0:N} 



Content: 



A self-contained unit of message data. 
All message types. 

id (optional) = (fragment name for document element); 
content-type (required) = (MIME type); 

schema (optional) = (URI to schema used for document; no default); 
xmlns (optional) = (URI to namespace used in document; no default); 
encoding (optional) = none (default) j base64 
The document data - XML, binary, free text, or any other format. 
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Appendix B.l - Message as posted by MyBiz.com 

<Message >xmlns="http: / /namespaces . grandcentral . com/mess age s/env-vOl" 
>type="request">test="f alse"> 
<Header> 
<To> 

<Servi ce >iame= " TheAcme Company / Supply " > 

<Arguments> 

< 1 [CDATA[action=ProcessPurchaseOrder] ] > 

< /Argument s> 
</Service> 

<Service>iame="BigBrother/GlobalListener ,, /> 
</To> 
<From> 

<Service>gcid="386b4520f4 89c217"/> 
</From> 

<Expiration >inits="hr">20</Expiration> 
</Header> 
<Body> 

<Document > i<^"doc-l" > content "type="text/xml" >encoding="none"> 
<PurchaseOrder > xmlns="urn : MyBiz : ns- 1 "> 
<Id>89987</Id> 

<Item>:ype="SKU M >3456-7 6987~34</Item> 

<Quantity>2</Quantity> 

<Cus t ome rNumbe r >3 4 8 9 < / Cus t ome rNumbe r > 

<Address>31>0cean>Front>Way£dmeCity, > AK, > 10984</Address> 
</PurchaseOrder> 
</ Document > 
</Body> 
</Message> 

Appendix B.2 - Message as Delivered to XpandiCo 

<Message>xmlns="http: //namespaces . grandcentral . com/messages/env-vOl" 
>type=" request "> 
<Header> 

<Session>id-"34b9f6dO89eb-b5el-0022-a37 6bf41cl65"/> 

<Token>value="84e309b38c56al8cb9835203"/> 

<To> 

<Service>gcid="3340f32c035d7 4 99">name- ,r xpandico/zipPlus4"> 
<Arguments> 

<! [CDATA[element=PurchaseOrder/Address/Zip] ]> 
</Arguments> 
</Service> 
</To> 
<From> 

<Service>gcid="386b4520f489c217">name="mybi2.com"/> 
</From> 
</Header> 
<Body> 

<Document >Ld="docA" > content ^type=" text /xml" >sncoding="none"> 

<PurchaseOrder >cmlns="http: //www. estandards . org/PurchaseOrderRequest"> 
<POId>89987</POId> 

<ItemXype-' r SKU">3 456-7 6987-34</Item> 
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<Quantity>2</Quantity> 
<CustomerID>3489</CustomerID> 
<Addre ss> 

<Street>31> Ocean > Front >Way</Street> 
<City>SomeCity, >AK</City> 
<Zip>10984</Zip> 
</Address> 
</PurchaseOrder> 
</Document> 
</Body> 
</Message> 

Appendix B3 - Response Message as Returned from XpandiCo 

<Message > xmlns= M http : / /namespaces . grandcentral . com/messages / env-vOl " 
>type="response"> 
<Header> 

<Token>value="84e309b38c56al8cb98 35203" /> 
<From> 

<Service >iame="xpandico/zipPlus4"/> 
</From> 
</Header> 
<Body> 

<Document>id="xfm-doc" > content^type="text /xml" >encoding^"none"> 

<PurchaseOrder >cmlns="http: / /www . estandards . org/PurchaseOrderRequest"> 
<POId>8 9987</POId> 

<Item>type=''SKU">3456-7 6987-34 </Item> 
<Quan t i t y>2 < / Quan 1 1 1 y> 
<CustomerID>34 89</CustomerID> 
<Address> 

<Street>31 >Ocean> Front >Way</Street> 
<City>SomeCity, >AK</City> 
<Zip>1098 4-0673</2ip> 
</Address> 
</PurchaseOrder> 
</ Document > 
</Body> 
</Message> 

Appendix B.4 - Message as Delivered to The Acme Company 

<Message >xmlns-"http: //namespaces . grandcentral . com/messages /env-vOl" 
>type-"request"> 
<Header> 

<Session>id="34b9f6d0-8 9eb-b5el-0022-a37 6bf41cl65'V> 

<Token>value-"30c481b28ad6e87b09f62182"/> 

<To> 

<Service>gcid="7 89e3223d9017f45" feame= M TheAcmeCompany/Supply"> 
<Arguments> 

<! [CDATA[action=-ProcessP-urchaseQrder] ]> 
< /Argument s> 
</Service> 
</To> 
<From> 
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<Service>gcid="386b4520f489c217">name= n mybiz.com"/> 
</From> 
</Header> 
<Body> 

<Document > id="doc-3" >contenttrype="text/xml" >encoding="none"> 

<PurchaseOrder>cmlns="http: //www. estandards . org/PurchaseOrderRequest"> 
<POId>89987</POId> 

<ItemXype="SKU">3456-76987-34</Itein> 
<Quantity>2</Quantity> 
<CustomerID>BX004 5012</CustomerID> 
<Address> 

<Street>31 > Ocean > Front >Way</Street> 
<City>SomeCity, >AK</City> 
<Zip>10984~0673</Zip> 
</Address> 
</PurchaseOrder> 
</ Document > 
</Body> 
</Message> 

Appendix B.5 - Response Message to MyBiz.com as Posted by The Acme Company 

<Message>xmlns="http: / /namespaces . grandcentral . com/me s s age s/env-vOl" 
>type= "response" > 
<Header> 

<Token>value="30c4 81b2 8ad6e87b09f 62182"/> 
<From> 

<Service>iame= n TheAcmeCoHipany/Supply"/> 
</From> 
</Header> 
<Body> 

<Doc*oment >id= w resp_doc" > content ^type="text/xml " >encoding="base64"> 
2Sl34rkuwkloirlmnm51oli2sinn7f slk7ui8 8u98wq7rsdolikjhdf loi9rkj j f 
</Document> 
</Body> 
</Message> 
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